home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / sortconf.zip / SORTCONF.DOC < prev    next >
Text File  |  1992-07-02  |  8KB  |  156 lines
  1.  
  2.                                S O R T C O N F
  3.                                + + + + + + + +
  4.                     Version 1.13             July 2, 1992
  5.  
  6.                                       by
  7.                                Michael A. Conley
  8.  
  9.                    [Requires BRUN40.EXE anywhere in the path]
  10.  
  11.              A public domain utility for Wildcat! version 3.x SysOps
  12.                          from the Charlatan's Cabin BBS        
  13.                                  (213) 654-7337
  14.  
  15. WHAT IT DOES:
  16. =============
  17.  
  18. SORTCONF reads your Wildcat! version 3.0 data files and its own configuration
  19. file to produce a listing of your conferences.  You may group conferences in
  20. a variety of ways ... for example, you could create a group of all of the
  21. computer software related conferences from multiple networks ... and then you
  22. could create another group for each network.  The possibilities are endless.
  23. (Actually you can create 20 groups ... not quite endless, but how long a 
  24. bulletin do you think they're gonna read??)  You may also choose whether to
  25. sort an individual group by ascending number or by alphabetical sequence
  26. based on the name.
  27.  
  28. SORTCONF can write multiple output files, so you could use the display as 
  29. a bulletin as well as using it as CONFLIST.BBS in your display file area.
  30. See below for setup options.
  31.  
  32. THIS VERSION:
  33. =============
  34. Reduces overall memory requirements, fixes a bug which could cause it to
  35. hang if it ran out of memory.
  36.  
  37. SETTING UP:
  38. ===========
  39.  
  40. STEP 1: Place SORTCONF.EXE and SORTCONF.CFG in the same directory where 
  41.         your MAKEWILD.DAT resides.  SORTCONF will search the DOS PATH
  42.         for these files if it needs to, but it's a good idea to keep
  43.         everything together.
  44.  
  45.         Be sure that you have BRUN40.EXE available in the path.  This 
  46.         Microsoft runtime module is required for the program to run.  
  47.         If you don't already have it, it's probably available on the 
  48.         BBS where you got this program, or you may call the Charlatan's 
  49.         Cabin BBS.  See below for details.
  50.  
  51. STEP 2: Edit the SORTCONF.CFG file to suit your preferences.  
  52.         Here's a sample of the configuration file format.  
  53.         SORTCONF.CFG is also included in this .ZIP file.
  54.  
  55. OUTFILE=C:\WC30\DISP\CONFLIST.BBS /CLS /COLOR
  56. OUTFILE=C:\WC30\BULL\BULL18.BBS /CLS /COLOR
  57. OUTFILE=C:\WC30\CONFLIST.CCB
  58. GROUP=Listing of Local Conferences /INCLUDE=0-3
  59. GROUP=Listing of Computer Software-related Conferences /INCLUDE=101-103, 201, 204, 330-335, 410
  60. GROUP=Listing of Non-Computing Hobby Conferences /INCLUDE=104-110, 121, 123, 205-220, 306-310, 415-418, 422
  61. GROUP=Listing of SmartNet EchoMail Conferences /SORT /INCLUDE=201-230    
  62. GROUP=Listing of Intelec(tm) Network Conferences /SORT /INCLUDE=301-340
  63. GROUP=Listing of Pet Net EchoMail Conferences /INCLUDE=351, 352, 355-360, 370-380
  64.  
  65. The above lines are a sample configuration file for SORTCONF.  Only one
  66. of each type of line is required ... additional groupings are optional, 
  67. as explained below.
  68.  
  69.         OUTFILE=      There may be 1 to 10 of these lines.
  70.                       This is the complete drive and path and filename of 
  71.                       each output file.  If you use CONFLIST.BBS and place 
  72.                       it in your display directory, then Wildcat! will use 
  73.                       it whenever a caller asks for a list of conferences.
  74.  
  75.                       Two optional switches may be included.  
  76.                       /CLS places a clear screen code in front of 
  77.                       the file.
  78.                       /COLOR places Wildcat! @-codes in the file to 
  79.                       produce a color display.
  80.  
  81.         GROUP=        You may include 1 to 20 of these lines.  
  82.                       The text immediately after the label (GROUP=) 
  83.                       will be used as a header for that section of 
  84.                       the list.  There are two switches:
  85.  
  86.                       /SORT ... if this is present following the group
  87.                       name, the section will be sorted in alphabetical
  88.                       order.  If it's not found, the section will be in
  89.                       ascending numerical sequence.
  90.  
  91.                       /INCLUDE= ... This is a required switch, and it
  92.                       contains the list of conferences you want to 
  93.                       include in that section of the list. 
  94.  
  95.                       You may list individual conferences, or specify
  96.                       one or more ranges of conferences, as shown in 
  97.                       the examples above.  
  98.  
  99.                       IMPORTANT: You MUST separate individual conferences
  100.                       with commas, and use a hyphen to link ranges of
  101.                       commas.
  102.  
  103.                       NOTE that you may select conferences for a group 
  104.                       based on any criteria, such as computer software, 
  105.                       and group together conferences from several networks, 
  106.                       then later make a group of all the conferences from a 
  107.                       particular net without regard to topic.  
  108.  
  109. STEP 3: SORTCONF will check the directory where it is run for text files 
  110.         to import into your display file. One of these can appear at the 
  111.         beginning of the display.  If SORTCONF finds "SORTCONF.000" it will
  112.         include it at the top of the display.  If it's NOT found, then
  113.         SORTCONF will display the name of your BBS in a color box.  You may
  114.         include Wildcat! 3.x color codes (@xx@) in the header file or in 
  115.         any of the other comment files and they will be passed to the display
  116.         file.
  117.  
  118.         Before EACH group, after the Header (see the configuration file) you
  119.         may also import comments.  Create a text file for each group, named 
  120.         as SORTCONF.001, SORTCONF.002, etc.  The contents will be imported 
  121.         to the display file immediately before the sorted listing of con-
  122.         ferences.  You may choose to include Wildcat! 3.x color codes (@xx@)
  123.         these files and, if color is specified in the display file, they will 
  124.         be passed to the display file. Otherwise, they will be stripped out.
  125.  
  126. RUNNING THE PROGRAM:
  127. ====================
  128. After the configuration file is prepared,  you can do a trial run by simply
  129. typing SORTCONF at the DOS command line.  Remember that the included text
  130. files, if you use them, must be in the same directory where SORTCONF is 
  131. started, usually the WC30 startup directory.  SORTCONF will search the DOS
  132. path for its own configuration file and for MAKEWILD.DAT and CONFDESC.DAT.
  133. Both of those are created and maintained by MAKEWILD, and are required for
  134. SORTCONF to look up the names & numbers of conferences to display.
  135.  
  136. PROBLEMS, SUGGESTIONS:
  137. ======================
  138. SORTCONF is public domain.  I don't seek or accept any donations for this or
  139. any of my other Wildcat! utility programs, including TODAYBBS, FLOP, MSTAT,
  140. USTAT, and others.
  141.  
  142. I welcome suggestions, and will try to help (no guarantees) if there are
  143. problems.
  144.  
  145. You may contact me at The Charlatan's Cabin BBS  (213) 654-7337.  Mention
  146. your Wildcat! registration number in the comment and you'll be upgraded to
  147. membership without the usually required registration by mail.
  148.  
  149. You may also leave a message via CompuServe (70250,220).
  150.  
  151. Please, NO VOICE CALLS.  This isn't meant to be unfriendly, but with
  152. the price of public domain software these days ... I just can't afford
  153. to be "on call."  I WILL respond to your questions via my BBS or CompuServe,
  154. or via the Mustang Software registered SysOp BBS.
  155.  
  156.